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Generic Programming 
What's the big picture? 


Generic programming is when you write a 
function or class in a manner so that it can 
process many different types of data. 


Like a generic sorting function that can sort an 
array holding ANY type of value 


Or a generic linked list class that can 
hold ANY type of variable 


int main() { l l Create a linked list 
list<int> list_of_integers; holding any type of [KK 
list<string> list_of_strings; data in ONE LINE! 


list_of_integers.push_back(42); 
list_of_strings.push_back("I*'s LIT”); 


Once you define such a generic function or class, you 
can quickly reuse it to solve many different problems. 


Part 1: Allowing Generic Comparisons 


Consider the following main function that compares 
various objects to each other... 


int main () 

{ 
ant il => 3; 12 = 5; 
if (il > i2) 


cout << “il is bigger”; 


Circ a(5), b(6); 
if (a > b) 


cout << “a was bigger”; 


Dog fido(10), spot (20); 
if (fido > spot) 


cout << “fido is bigger”; 


Notice that the way we compare 
two dogs (by weight) is 
different than the way we 
compare two circles (by radius). 


Wouldn't it be nice if we 
could compare objects like 
circles and dogs just like we 
compare two integers? 


We can! Let's see how! 


class Dog 
{ 
public: 

bool operator< (const Dog éother) const 


{ 
if (m weight < other.m weight) 
return true; 
return false; // otherwise 


} 


int getWeight() const 
{ return m weight; } 


private: 
int m weight; 


E 


bool operator>=(const Dog &a, 
const Dog &b) 


{ 
if (a.getWeight() >= b.getWeight()) 
return true; 
return false; // otherwise 
} 


Custom Comparison Operators 


You can define comparison operators for a class/struct! 
Here are two examples, one defined inside your class 
declaration and one outside, so you can see both versions. 
Do these look familiar? They're just like an assignment 
operator, only they compare two objects instead of 
assigning one to another. 
You can define ==, <, >, <=, >= and != 
Your comparison function should compare object a against 
object b using whatever approach makes sense. Here we 
say dog a is greater than dog b if its weight is bigger, but 
you could have compared bite or bark too 
All comparison operators must return a Boolean value: true 
or false. In this example, our >= function should return 
true if a >= b., and false otherwise. 
Comparison operators defined outside the class have two 
parameters, one for each of the two operands (see 
operator >= left) 
if (a >= b) cout << “a is >= b\n": 
Comparison operators defined inside the class have a single 
“other” parameter, just like a copy constructor does. See 
operator < above-left. The “other” parameter refers to the 
value to the right of the < operator: 
if (a < other) cout < ‘a is less than the item right of <“ 
If a comparison operator is defined inside your class 
declaration, it may access private members (see how 
operator< accesses m_weight) 
But if the operator is defined outside your class, then it 
may only use public member functions to compare objects. 
See how operator>= uses getWeight() rather than 
accessing m_weight, which is private. 
All comparison operators must take const reference 
parameters. And don't forget to make your member 
comparison operators const (see the const after 
operator<(...) const; 


Oh, and by the way... since a and b are const, our comparison Custom Comparison Operato rs 


function can only call const functions in Dog! So you'll need to 
make sure functions like getWeight() are const in your class, e.g.: 


class Dog { 


public: 
int getWeight() const; 
} 


And here's how they 
work! 


bool operator>=(const Dog &a, const Dog &b) 


if (a.getWeight() >= b. 
return (true) ; 
else return (false); 


} 


Simply using the 
operator in your code 
causes C++ to call your 

comparison function! 


Y ~| € 10 Errors 0 Warnings 0 Messages 
Description 
€31 error C2662: ‘int Dog::getWeight(void)' : cannot convert 'this' pointer from ‘const Dog' to ‘Dog &' 


fido 


If you forget to make functions 


like getWeight() const, you'll see spot 
this kind of cryptic error... 


nt main () 


Dog fido(5) ,/ spot (3) ; 
if (fido >= spot) 
cout << “fido wins”; 
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// the old way 
void SwapCircle (Circ &a, Circ &b) 


{ 


Circle temp; 


temp = a; 
a = b; 
b = temp; 


} 
void SwapDog (Dog &d1, Dog &d2) 
{ 

Dog temp; 

temp = a; 

a=b; 

b = temp; 


int main () 


Circle a(5), b(6); 
Dog c(100), d(750) ; 


SwapCircle (a,b); 
SwapDog (c,d) ; 
} 


Part 2: Writing Generic Functions 


In the code to the left, we've written several 
different swap functions that swap the two 
values passed into the function. 

Wouldn't it be nice if we could write one swap 
function and have it work for any data type, like 
the code below? 

Let's see how! 


// the new way 


int main () 


{ 


(we'll learn how in a sec) 


Circ a(5), b(6); 
Dog c(10), d(75); 
int e = 5, f = 10; 


OurGenericSwap (a,b) ; 
OurGenericSwap (c,d); 


OurGenericSwap (e,f) ; 


The Solution 


In C++, we use C++'s “template” feature to solve this problem. 


template <typename Item> 


Gold suspen ca Tom ib) To turn any function into a 


{ “generic function," do this: 
Item temp; 
temp = a; 1. Add the following line above 
TaD your function: 
b = temp; 

i template <typename poop> 


a eee earn 2. Then use xxx as your data 
int main () ` 


i type throughout the function: 
Dog d1(10), d2 (20); 
Circle c1(1), c2(5); 


swap (d1 ,d2) Now you can use your generic 
swap (cl1,c2) ; 


function with any data type! 


swap(xxx a, Xxx b) 


Function Template Details 


Always place your templated functions in a header file, as shown below and right. 
Then include your header file in your CPP file(s) to use your function! 


You must put the ENTIRE template Swap- H 
function body in the header file, not just | template <typename Data> 
the prototype, or you'll get an error. swap (Data &x, Data &y) 
Data temp; 
See below for what not to do! temp = x; 
x = y; 
y = temp; 
} 
Swap.H 
template <typename Data> ACOG I iogram CEI 
void swap (Data &x, Data &y); #include “Swap.h” 
int main () 
{ 
ERROR! int a=5, b=6; 


swap(a,b); // GOOD! 
} 
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e ° void swap (Dog &x, Dog &y) 
Function Template Details © 
e Each time you use a template function with a different temp = x; 
type of variable (e.g., int, string, Dog, ...), the compiler s B aa 
generates a new version of the function in your program | } 
to handle that type of variable! void swap(int &x, int &y) 
e So if we define the swap function below, and used it ane 
with the main function shown, C++ will actually generate 
all of the code on the right and then compile it! ao 
e So you can think of templates as a time-saving/bug- y = temp; 
reducing/source-simplifying technique rather than one |’ 
that reduces the size of your compiled program. os sesh a 
string temp; 
temp = x; 
Swap .H x oi 
template <typename Data> } ia 
void swap(Data &x, Data &y) 
{ int main () 
Data temp; #include “Swap.h" { 
int main () Dog a(13), b(41); 
temp = x; { swap (a,b) ; 
x=y; Dog a(13), b(41); sae 
y = temp; swap (a,b) ; int P= 1l, q- 2; 
} int p=-1, q=-2; swap (p,q); 
swap (p,q) r > "aU Sa . 
string x(a yD String x(a"); Y DBD"); 
swap (x,y) ; swap (x,y) ; 
int r=10, s=20; int r=10, s=20; 
Swap ttia) swap (r,s); // ???? 


Function Template Details 


You MUST use the template data type (e.g. Data) to 
define the type of at least one formal parameter, or 
youll get an ERROR! 


GOOD: BAD: 
template <typename Data> template <typename Data> 
void swap(Data &x, Data &y) Data getRandomItem(int x) 
{ 
Data temp; Data temp[10]; 
temp = x; return (temp [x]) ; 
x = y; } 
y = temp; 
} 


Data was not used to 
specify the type of 
any parameters. 


Data used to specify the 
types of x and y! 
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Function Template Details 


If a function has two or more 
“templated parameters," with the same type (e.g. Data) 


you must pass in the same type of variable/value for both. 


Data max(Data x, Data y) 
{ 


if (x > y) 
return x; 

else 
return y; 


#include “max.h" 
int main () 
{ 
int i = 5; 
float f = 6.0; 
cout << max(i,f); // ERROR! 


Dog c; 
Cat d, e; 
e = max(d,c); // ERROR! 


A Hairy Template Example 


bool operator>(const Dog &a,const Dog &b) 
{ 
if (a.weight() > b.weight() ) 
return (true) ; 
else return(false) ; 


} 


bool operator>(const Circ &a,const Circ &b) 
{ 
if (a.radius() > b.radius()) 
return (true) ; 
else return(false) ; 


If your templated function 

uses a comparison operator on 
templated variables then C++ expects 
that all variables passed in will have 
that operator defined. 

In the example below, we compare 
Dogs, Circles and ints using the > 
operator, so we must have operator> 
defined for Dogs and Circles for this 
code to work. 

Since C++ automatically provides > for 
ints, you don't need to (nor are you 
allowed to) define your own operator> 
for ints. 

If you forget to define a required 
operator, you'll get an error when your 
templated function tries to compare 
two items. 


template <typename Data> 
void winner (Data &x, Data &y) 


{ 
if (x > y) 
cout << “first one wins!\n”; 
else 
cout << “second one wins!\n”; 


int main () 


{ 


int 11=3, i12=4; 
winner (il ,i2) ; 

Dog a(5), b(6); 
winner (a,b); // works! 


Circ c(3), d(4); 
winner (c,d); // works! 
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Multi-type Templates 


template <typename Typel, typename Type2> 
void foo(Typel a, Type2 b) 
{ 


Typel temp; 
Type2 array[20]; 


Temp = a; 
array[3] = b; 
// etc... 


int main() And yes, just in case 


foo(5,"barf"); // OK! you were guessing... 


foo(“argh",6); // OK! 
foo(42,52); // OK! 


You can do this type of 


thing too... 
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Part 3: Writing Generic Classes 
We can use templates to make entire classes generic too: 


template <typename Item> 


class HoldOneValue 
{ 
public: 

void setVal (Item 


o use the prefix: 


template <typename xxx> 


= before the class definition itself... 
{ P| 
m = r 


void printTenTimes () 


{ 


Then update the appropriate types 
in your class... 


Now your class can hold any type of 
data you like - just like the C++ stack 
or queue classes! 


In classes with externally-defined member functions, 
things get ugly! 


template <typename Item> 
class Foo 


{ 
public: 
void setVal (Item a); 
void printVal() ; 
private: 
Item m a; 


Fo 


template <typename Item> 
void Foo<Item>: :setVal (Item a) 


{ 
} 


template <typename Item> 
void Foo<[tem> ‘printVal () 
{ 

cout << ma << "\n"; 
} 


You add the prefix: 


template <typename xxx> 


before the class definition 
itself... 


AND before each function 
definition, outside the class. 


THEN update the types to 
use your templated type... 


Finally, place the postfix: 


<XXX> 


Between the class name and 
the :: in all function defs. 


Template Classes 


Template classes are very useful when were building 
container objects like linked lists. 


#include “linkedlist.h” 
int main( ) 


{ 
Dog fido(10) ; 


LinkedList<Dog> dogLst; 


i ; template <class HoldMe> 
dogLst.insert (fido); 


class LinkedList 


{ 


LinkedList<string> names; 


public: 
names .insert (“Seymore”) ; LinkedList() ; 
names .insert (“Butts”); bool insert (HoldMe &value) ; 
} bool delete (HoldMe &value) ; 


bool retrieve(int i, HoldMe &value) ; 
int size(); 
~LinkedList() ; 

private: 


E 
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Carey's Template Cheat Sheet 


- To templatize a non-class function called bar: 


Update the function header: int bar(int a) > template <typename ItemType> ItemType bar(ItemType a); 
Repiace appropriate types in the function to the new ItemType: { int a; float b; ... } > {ItemType a; float 


- To templatize a class called foo: 


Put this in front of the class declaration: class foo { ... }; > template <typename ItemType> class foo { ... }: 
Update appropriate types in the class to the new ItemType 
How to update internally-defined methods: 
For normal methods, just update all types to ItemType: int bar(int a) { ...} > ItemType bar(ItemType a) { ... } 
Assignment operator: foo &operator=(const foo d&other) > foo<ItemType>& operator=(const foo<ItemType>& other) 
Copy constructor: foo(const foo &other) > foo(const foo<ItemType> &other) 
For each externally defined method: 
For non inline methods: int foo::bar(int a) > template <typename ItemType> ItemType foo<ItemType>::bar(ItemType a) 


For inline methods: inline int foo::bar(int a) > template <typename ItemType> inline ItemType 
foo<ItemType>::bar(Item Type a) 


For copy constructors and assignment operators 
foo &foo::operator=(const foo &other) > foo<ItemType>& foo<ItemType>::operator=(const foo<ItemType>& other) 
foo::foo(const foo &other) > foo<ItemType>::foo(const foo<ItemType> &other) 

If you have an internally defined struct blah ina class: class foo { ... struct blah { int val; }  ... }: 

Simply replace appropriate internal variables in your struct (e.g., int val;) with your ItemType (e.g., ItemType val;) 

If an internal method ina class is trying to return an internal struct (or a pointer to an internal struct): 
You don't need to change the function's declaration at all inside the class declaration; just update variables to your 
ItemType 

If an ill as method ina class is trying to return an internal struct (or a pointer to an internal 

struct): 

Assuming your internal structure is called “blah", update your external function bar definitions as follows: 


blah foo::bar(...) { ... } > template<typename ItemType>typename foo<ItemType>::blah foo<ItemType>::bar(...) { ... } 
blah *foo::bar(...) { ... } > template<typename ItemType>typename foo<Item Type>::blah *foo<ItemType>::bar(...) { ... } 


- Try to pass templated items by const reference if you can (to improve performance): 


Bad: template <typename ItemType> void foo(ItemType x) 
Good: template <typename ItemType> void foo(const ItemType &x) 


Part 4: The Standard Template 
Library (aka “STL") 


The Standard Template Library or STL is a collection of 
pre-written, tested classes provided by the authors of C++. 


These classes were all built using templates, meaning 
they can be used with many different data types. 


You can use these classes in your programs and it'll 
save you hours of programming! Really! 


As it turns out, weve already seen 
two of these STL classes! 
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The "STL" 


We've already seen several STL classes 
(which are all implemented using templates) 


#include <stack> 
#include <queue> 
using namespace std; 


int main () 


{ 


stack<int> is; 
queue<string> sq; 
is.push (5) ; 
is.push(10) ; 


sq.push (“goober”) ; 


The Stack and Queue classes 
are both part of the STL. 


These classes are called 
“container” classes because 
they hold groups of items. 


The STL has many more 
container classes for your 
use as well! 


Let's learn about them... 


Cool STL Class #1: Vector 


The STL vector is a template class that works just like an 
array, only it doesn't have a fixed size! 


vectors grow/shrink automagically when you add/remove items. 


#include <vector> 


int main () 


{ 


std: 
std: 
std: 


std: 


:vector<string> strs; 
:vector<int> nums ; 


:vector<Robot> robots; 


:vector<int> geeks (950) ; 


To use vectors in your program, 
make sure to #include <vector>! 


To create an empty vector (with 
O initial elements) do this... 


Or create a vector that starts 
with N elements like this... 


All of a vector's initial elements 
are automatically 
initialized/constructed (e.g., 
geeks 950 values start at zero)! 


Cool STL Class #1: Vector 


#include <vector> 


using namespace std; 


int main () 


{ 


vector<string> strs; 
strs.push_ back (“Carey”) ; 
strs.push back(“Scott”) ; 
vector<int> vals(3); 


vals.push_back (123) ; 


Once you've created a vector, 
you can add items, change 
items, or remove items... 


To add a new item to the very 
end of the vector, use the 
push_back command. 


strs 


vals 
[1] [1] 


[2] 
[3] 
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Cool STL Class #1: Vector 


#include <vector> 


using namespace std; 


int main () 


{ 
vector<int> vals(3); 


vals.push_back (123) ; 

cout << vals.back(); // prints 123 
vals[0] = 42; 
cout << vals[3]; 


vals[4] = 1971; 


cout << vals[7]; 


To read or change an existing item 
from a vector, use brackets to access it. 
You can use the front or back methods 
to read/write the first/last elements 
(if it's not empty). 

But be careful! You may only use 
brackets to access existing items! 

In this example, our vector has 4 items 
(the initial three values and 123 which 
was pushed on the end). So you can only 
access entries O - 3. 

Nor can you add new items past the 
end of the vector by just setting them, 
e.g: vals[1000] = 10; 

This will cause a crash, since our 
vector only has 4 items. 


vals 


[0] 
[1] 
[2] 


Cool STL Class #1: Vector 


To remove an item from the 
back of a vector, use pop_back. 


#include <vector> 


This actually shrinks the vector 
(afterward it has fewer items) 


using namespace std; 


int main () 
{ Be careful! Once you've removed 
vector<int> vals (3); an item from the vector, you can't 


access its slot with brackets! 


vals.pop_back() ; We'll learn how 

vals.pop_back () to remove an 

vals[3] = 456; item from the 
iddle/front of 


a vector in justa 
bit... 


i Cool STL Class #1: Vector 


e Vectors are implemented using dynamically-allocated arrays with new/delete. 

e The vector will initially have just a few allocated slots, with an official size of O items. 

e Once you fill up those slots by adding values, the vector object will allocate a bigger array, copy 
all of its current items over to the new array, and then delete the old, smaller array. 

e So once ina while, adding an item could take a looooong time. since it will not just add the one 
item, but move everything over to a new array. 

e But on average, adding an item to a vector is pretty fast, since this copying operation is amortized 
across many additions, most of which just take one step. 


#include <vector> 
using namespace std; 


int main () 
{ 
vector<int> vals(2,444); 


vals.push_back (999) ; 
cout << vals.size() ; 


if (vals.empty() == false) 


cout << “I have items!”; 


To get the current number of 
elements ina vector, use the 
size method. 


And to determine if the vector 
is empty, use the empty method! 


Carey says: 


Remember - the size( ) function 
works for vectors but NOT arrays: 
int arr[10]; 
cout << arr.size( ); // ERROR! 


° Cool STL Class #2: List 


The STL list is a class that works just like a linked list. 
(So you can be lazy and not write your own) 


#include <list> // € don’t forget! 
using namespace std; 


int main () 

{ 
list<float> LE: 
1f.push_back(1.1); 
1f.push_back (2.2); 
1f.push_front(3.3); 


cout << 1£[0] << endl; // ERROR! 


Like vector, the list class 
has push_back, pop_back, 
front, back, size and empty 
methods! 


But it also has push_front 
and pop_front methods! 


These methods allow you 
to add/remove items from 
the front of the list! 


Unlike vectors, you can't 
access list elements using 
brackets. 
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Cool STL Class #2: List 


So when should you use a vector and when should you use a list? 

Since vectors are based on dynamic arrays, they allow fast access to any element (via brackets) but 
adding new items is often slower. 

The STL list is based ona linked list, so it offers fast insertion/deletion, but slow access to middle 
elements. 

Don't forget to put std:: in front of your list definition, e.g., std::list<float> unless you first adda 
“using namespace std;" command, as shown below. | f 


{ 


#include <list> // € don’t forget! 


using namespace std; 


int main () 


list<float> Lf: 
l1f.push_back (1.1); 
l1f.push_back (2.2); 
lf.push_front(3.3); 


Iterating Through The Items 


Question: Given an STL container class (like a list), how do 
you iterate through its elements? 


eh ceacu anaes Unfortunately, other than 
using namespace std; 


the vector class which 
allows you to use brackets 
[ ] to access elements... 


int main () 
{ 
list<int> poof; 


Beare None of the other STL 
aera tae containers have an easy-to- 
poof.push_back(7) ; a n 

poof .push back (1) ; use “retrieve” method to 


quickly go thru the items. 


// how do I enumerate elements? 


for (int j=0;j<poof.size() jes Wont work... 


cout << poof.retrieve(j) ; 


Iterating Through The Items 


To enumerate the contents of a container (e.g., a list or 
vector), you typically use an iterator variable. 


int main() 
vector<int> myVec; 
myVec.push_back(1234); 


myVec.push_back(5); 
myVec.push_back(7); 


An iterator variable is just like a 
pointer variable, but it’s used 
just with STL containers. 


Typically, you start by pointing an 
iterator to some item in your 
container (e.g., the first item). 


Just like a pointer, you can 
increment and decrement an 
iterator to move it up/down 
through a container's items. 


You can also use the iterator to 
read/write each value it points to. 
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int main() 


vector<int> myVec; 


myVec.push_back(5); 
myVec.push_back(7); 


myVec.push_back(1234); 


vector<int>:: iterator it; 


Defining an Iterator 


To define an iterator variable, 
write the container type 
followed by two colons, 
followed by the word iterator 
and then a variable name. 


Here are a few more examples: 
vector<string>::iterator it2; 
list<float>::iterator it3; 
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STL Iterators 


int main() 


{ 


vector<int> myVec; 


myVec.push_back(1234); 
myVec.push_back(5); 
myVec.push_back(7); 
vector<int>::iterator it: 
it = myVec.begin(); 

cout << (*it) ; 


myVec 


it 


How do you use your iterator? 

Iterators start out pointing at nothing, so before 
using one you must point it at an item in your 
container... 

For example, to point your iterator at the first 
item, simply use the container's begin() method. 
When you call the begin() method it returns the 
position of the very first item in the container. 
Once the iterator points at a value, you can use 
the * operator with it to access the value. 
When we use the * operator with an iterator, 
this is called operator overloading. 

The C++ guys realized that you already use the * 
to dereference pointers, so why not use it to 
dereference iterators as well! 


<—myVec.begin() 
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STL Iterators 


int main() 


vector<int> myVec; 


myVec.push_back(1234); 
myVec.push_back(5); 
myVec.push_back(7); 
vector<int>::iterator it; 

it = myVec.begin(); // #1 

cout << (*it) ; // prints 1234 
it++; // #2 

cout << (*it) ; // prints 5 


After line #1 


myVec 

+ Ca 
[1] 
[2] 


<«myVec.begin() 


You can move your 
iterator down one item by 
using the ++ operator! 


Now the iterator points to the 
second item! 


In a similar way, you can use 
the -- operator to move 
the iterator backward! 


After line #2 


myVec 


it [S19 <«myVec.begin() 
[1] 
[2] 
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STL Iterators 


int main() 


vector<int> myVec; 


myVec.push_back(1234); 
myVec.push_back(5); 
myVec.push_back(7); 
vector<int>::iterator it: 

it = myVec.end(); // #1 

it--; // #2 
cout << (*it); // Prints 7 


After line #1 


<+—myVec.end() 


What if you want to point your iterator to the 
last item in the container? 

Each container has an end() method, but it 
doesn't point to the last item! 

It points JUST PAST the last item in the 
container... 

So if you want to get to the last item, you've got 
to first point it at end() and then decrement it! 
Now why would they do that - we'll see in the 
next slide! 


After line #2 


myVec 


[0] <— myVec.begin() 


[1] 
[ 


<«—myVec.end() 
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STL Iterators 


int main() 
vector<int> myVec; 


myVec.push_back(1234); 
myVec.push_back(5); 
myVec.push_back(7); 
vector<int>::iferator it; 
it = myVec.begin(); 


while ( it != myVec.end() ) 
{ 


cout << (*it); 
it++; 
} 
} 


1234 5 7 


So you can make loops, of course! 
When you loop through a container, 
you don't want to stop at the last 


item, you want to stop once you've 
gone JUST PAST the last item! 


That's when you know you're done! 


myVec 


<— myVec.begin() 


«— myVec.end() 
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STL And Classes/Structs 


Of course, you can also create STL 
containers of classes or structs! 


{ 
public: 
void beNerdy( ); 
}: 
int main() 
list<Nerd> nerds; 
Nerd d; 


nerds.push_back(d); 


it = nerds.begin(); 
(*it).beNerdy(); 
it->beNerdy(); 


list<«Nerd>::iterator it: 


And here's how you would access 
the items with an iterator. 


You can use the * operator and 
then the dot operator... 


Or you can also use 
the -> operator if you like! 


Const Iterators and Headaches 


You'll know you made this mistake if you see something like this: 


error C2440: 'initializing' 
'std:: List const iterator< Mylist>' to 


: cannot convert from 
"std: : List _iterator<_Mylist>' 


void tickleNerds(const list<string> & nerds) 
{ 
list<string>::iterator it; // won't work 
for (it=nerds.begin(); it != nerds.end(); it++) 
cout << *it << " says teeheel\n"; 


} 


int main() 


{ 


list<string> nerds; 


nerds.push_back("Carey"); 
nerds.push_back("David"): 


tickleNerds(nerds); 
} 


Sometimes you'll pass a container as a 
const reference parameter... 


To iterate through such a container, 
you can't use the regular iterator! © 


But it's easy to fix. You just use a 
const iterator, like this... 


list<string>::const_iterator it; // works!!! 
for (it=nerds.begin(); it != nerds.end(); it++) 
cout << *it << “` says teehee! \n"; 
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STL Iterator Challenge 


{ 


int main () 


list<string> nerds; 


nerds .push_back (“John") ; 
nerds .push_back ("David") ; 
nerds .push back (“Carey”) ; 


list<string>::iterator itr; 
itr = nerds.begin() ; 


cout << *itr << endl; 
itrt++t; 
cout << *itr << endl; 


itr = nerds.end() ; 
itr--; 
cout << *itr << endl; 


What does it print out? 


nerds 


STL Iterators 


So what is an iterator, anyway? It looks like a pointer, 
sort of works like a pointer, but it’s *not* a pointer! 


An iterator is an object (i.e. a class variable) that knows 
three things: 


e What element it points to. 


- How to find the previous element in the container. 
e How to find the next element in the container. 


Let's see what this looks like in C++ code! 


class MyIterator 

{ 

public: 
int getVal(){ return cur->value; } 
void down() { cur = cur->next; } 
void up() { cur = cur->prev; } 


Node *cur; 


}? 


class LinkedList 


{ 


public: 
E pages ? This is obviously a simplification, but 
myTterseae tame: it gives you the general idea of how 
things work. 


temp.cur = m_head; 


int main () 
} { 
LinkedList GPAs; // list of GPAs 


private: 
Node *m_head; 


return (temp) ; 


; MyIterator itr = GPAs.begin() ; 
bi cout << itr.getVal(); //like *it 


itr.down () ; //like it++; 
cout << itr.getVal() ; 
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Other STL Containers 


So far we've learned how to use the 
STL to create linked lists and 
dynamic arrays (vectors). 


What else can the STL do for us? 


Cool STL Class #3: Map 


#include <map> 
#include <string> 
using namespace std; 


Maps allow us to associate 
two related values. 


int main () 


Let's say I want to associate 
{ = a bunch of people with each 
map< string int > name2Fone ; 

, person's phone number... 
name2Fone[“Carey”] = 8185551212; , 
name2Fone[“Joe”] = 3109991212; Ok. Names are stored in 

string variables, and phone 
#s in integers. 


Here's how we create a 
map to do this. 


Here's how I associate 
a given string to an integer. 


“Carey" > 8185551212 
“Joe" > 3109991212 


Cool STL Class #3: Map 


#include <map> 
#include <string> 
using namespace std; 


{ 


int a aaa 
map<string f int > name2Fone; 
name2Fone[“Carey”] = 8185551212; 
name2Fone[“Joe”] = 3109991212; 
// ERROR! 
name2Fone [4059913344] = “Ed”; 


map<int,string> fones2Names 


fones2Names [4059913344] = 
fones2Names [8183451212] 


NN Ed” = 
“AT m" F 


A given map can only associate 
in a single direction... 


For example, our name2Fone 
map can associate a 
string to an int, but not the 
other way around! 


So how would we create a map 
that lets us 
associate integers > strings? 


If you want to efficiently 
search in both directions, you 
have to use two maps. 


Cool! So how does the 
Map class work? 


“ How the Map Class Works 


struct pair 


#include <map> ‘ String first; 
#include <string> 
using namespace std; 


int second; 


int main () 

{ 
map<string,int> name 2Age ; 
name2Age[“Carey”] = 49; 
name2Age[“Dan”] = 22; 
name2Age[“David”] = 53; 


name2Age[“Carey”] = 39; // © 


name2 Age 


The map class basically stores each 
association in a struct variable! 

It uses your two types (in this case string 
and int) to create a new struct type with 
two fields, named first and second. 

The “first” variable has the left type in 
your map, string in this example. The 
“second” variable has the second type, int 
in this example. 

Then when you associate a new item, as 
we do when we associate Dan with 22, it 
adds a new struct variable with these 
values to its data structure 

As you can see, you can replace earlier 
associations with new ones. See how we 
reassigned Carey to 39 from its original 
value of 49. 


first Care 
second L_39 


first 
second L_22 


first Davic 
second 3 


44 


How to Search the Map Class 


#include <map> 
#include <string> 
using namespace std; 


int main () 


{ 


map<string,int> name 2Age ; 


map<string,int>::iterator it; 


it = name2Age.find(“Dan”) ; 


cout << (¥*it) .first; 
cout << (*it) .second; 
cout << it->first; 


// same thing 
cout << it->second; // as above 


To search a map for an association, you must 

first define an iterator to your map, as we do 

with the "it" variable to the left. 

Then you can call the map's find command in 

order to locate an association. 

Once we find our item, we can use the dot or -> 

operator to print out the mapped-from (first) 

and mapped-to (second) items. 

Note: You can only search efficiently based on 

the left-hand type (e.g., string)! So we can't do: 
it = name2Age.find(39); 


name2 Age 


first 
second 


first 
second 
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How to Search the Map Class 


{ 


} 


#include <map> 
#include <string> 
using namespace std; 


int main () 


map<string,int> name2Age ; 


map<string,int>::iterator it; 


it = name2Age.find(“Ziggy”) ; 
if ( it == name2Age.end() ) 
{ 
cout << “Not found!\n”; 
return; 


} 


cout << it->first; 
cout << it->second; 


Not found! 


What if the item you search for (e.g. 
“Ziggy") isn't in your map? You've got to 
check for this case! 

If the find method can't locate your item, 
then it tells you this by returning an iterator 
that points past the end of the map! 

We can check for and handle this! 


name2 Age 


first 


second 


first 
second 


first 
second 


name2 Age.end() 
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#include <map> 
#include <string> 
using namespace std; 


int main () 


{ 


map<string,int> name2Age ; 


map<string,int>::iterator it; 


for (it = name2Age.begin() ; 
it != name2Age.end() ; 
it++) 
{ 
cout << it->first; 
cout << it->second; 
} 
} 
Carey 39 
Dan 22 


David 53 


How to Iterate Through a Map 


To iterate through a map, simply use a for/while 
loop as we did for vectors/lists! 

As it turns out, the map always maintains its 
items in alphabetical order! 

Entries are ordered by the “first” item, so in 
this case, by the strings: Carey, Dan and David. 
This means that when you iterate thru them 
with an iterator, they're automatically ordered 
for you! (i.e., no sorting required!) 


name2 Age 


name2 Age.end() 
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Cool STL Class #3: Map 


struct stud // student class 
{ 


string name; 
int idNum; 


les 


bool operator<(const stud &a, const stud &b) 


return (a.name < b.name); 


} 


int main () 


{ 
map<stud,float> stud2GPA; 


stud d; 
d.name = “David Smallberg” ; 
d.idNum = 916451243; 


stud2GPA[d] = 1.3; 


You can even associate more complex data 
types like structs and classes. 

For example, this code allows us to 
associate a given Student with their GPA! 
But for this to work, you must define your 
own operators method for the left-hand 
class/struct! Why the < operator?!?! 

In this case, the left-hand side type is a 
stud (Student), therefore, for this to 
work we must define an operators method 
for stud (shown to the left) 

We define the operator< to allow our map 
to differentiate different items 

Right now, you might be asking: 

“Why not use operator== instead?" 

Well, if you think about it, defining the < 
operator is sufficient to do everything 
that defining the == operator can do and 
more. 

In this example, we differentiated 
students by their names in operators, but 
we could just have easily used their 
student ID, phone number, etc. to identify 
unique students. 


Cool STL Class #3: Map 


struct stud // student class 
{ 

string name; 

int idNum; 


les 


bool operator<(const stud &a, const stud &b) 


return (a.name < b.name); 


} 


int main () 
{ 
map<int,stud> phone2Stud; 


stud d; 
d.name = “David Smallberg” ; 
d.idNum = 916451243; 


stud2GPA[8183451234] = d; 


Note: You only need to define the 
operator< method if you're mapping 
from your own struct/class 
(it's on the left-hand-side 
of the map)! 


In this case, our student struct is on 
the right-hand-side, so we don't need 
to define an operator< method for it. 


Since there's already a less-than 
operator built in to C++ to compare 
integers, this phone2Stud definition 
will work as-is. 


49 


Cool STL Class #4: Set 


{ 


#include <set> 
using namespace std; 


int main () 


set<int> a; 
a. 
a. 
a. 
a. 


cout << a.size(); 


a.erase (2) ; 


insert (2); 
insert (3) ; 
insert (4) ; 
insert(2); // dup 


A set is a container that keeps 
track of unique items. 


Here's how you define a set of 
integers. 
Here's how you insert items into a set. 
If you insert a duplicate item into the 


set, it is ignored (since it's already in 
the setl). 


Use .size() to get the size of aset. 


Use .erase() to erase a member of the 
set. 
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Cool STL Class #4: Set 


struct Course 
{ 
string name; 
int units; 
}; 
bool operator<(const Course &a, 
const Course &b) 


return (a.name < b.name); 
} 
int main () 
{ 


set<Course> myClasses; 
Course lecl; 
lecl.name = “CS32"; 


lecl.units = 16; 


myClasses.insert(lecl) ; 


And of course, you can have sets 
of other data types as well! 


But as with our map, you need to 
define the operator< for your own 
classes (e.g., Course)! 


Otherwise you'll get a compile 
error! © 
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Searching/Iterating Through a Set 


#include <set> 
using namespace std; 


int main () 

{ 
set<int> a; 
a.insert(2) ; 
a.insert(3) ; 
a.insert (4) ; 


set<int>::iterator it; 


it = a.find(2); 
if (it == a.end()) 
{ 


cout << “2 was not found”; 


return (0) ; 


} 
cout << “I found “ << (*it); 


We can search the STL set using the find function 
and an iterator, just like we did for the map! 


BTW, you can iterate through a set's items just 
like we did with a map - and the items will also be 
alphabetically ordered! 


it = a.begin() ; 


while (it != a.end()) 

{ 
cout << *it; // alpha order 
ICF? 


‘Deleting an Item from an STL Container 


int main () 


{ 


set<string> geeks; 


geeks .insert ("carey"); 


geeks.insert ("rick") 
geeks ..insert ("alex") 


e 
7 


e 
7 


set<string>::iterator it; 


it = geeks.find("carey"); // #1 


if (it != geeks.end() ) 


{ 
// found my item!! 


cout << “bye bye “ << *it; 


geeks .erase (it); 


} 


// #2 


Most STL containers have an erase() 
method you can use to delete an item. 
First you search for the item you want to 
delete and get an iterator to it. 

Then, /f you found an item, use the erase() 
method to remove the item pointed to by 
the iterator. 


After line #1 


After line #2 
Ca 


alex 
rick 


bye bye carey 


; tn em trie ei 
Iterator Gotchas'! 


int main() Let's say you point an iterator 
{ to an item ina vector... 


If you add an item anywhere to the 


vector<string> x; 


x.push_back (“Carey”) ; vector you must assume your 
x.push back (“Rick") ; iterator is invalidated! 

z PSE ACE E E And if you erase that item or an 
vector<string>::iterator it; item that comes before it, ares 


iterator is also invalidated! 
it = x.end(); 


it--; // it points at Alex | Why? When you add/erase items in 
i a vector, it may shuffle its memory 

x.push_back("Yong"); // add around (without telling you) and 

cout << xit; // ERROR! then your iterators may not point 


to the right place any more! 


Leaving the old iterator pointing to a 


I'm no longer 
ut g random spot in your PC's memory. 


valid!!! © 
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Deletion Gotchas 


int main () 


{ 
set<string> s; 


s.insert("carey") ; 
s.insert ("rick") ; 
s.insert ("alex"); 


set<string>::iterator it; 


it = s.find("carey") ; 


s.insert(’Yong"); // add yong 
s.erase(“rick"); // removes rick 


cout << *it; // prints “carey”! 
s.erase("carey"); // removes carey 


cout << *it; // error! 


Fortunately, this same 
problem doesn't occur with 
sets, lists or maps. 


With one exception... 


If you erase the item the 
iterator points to, then you've 
got troubles! 


Part 5: STL Algorithms 


See: http://en.cppreference.com/w/cpp/algorithm 


The STL also provides some 
additional functions that work with 
many different types of data. 


For instance, the find() function 
can search most STL containers 
and arrays for a value. 


And the set_intersection function can 
compute the intersection of 
two sorted sets/lists/arrays of data. 


And the sort() function can sort 
arrays/vectors/lists for you! 


Let's learn about the sort() function! 
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First, to use the STL sort() 


function, or any of its other The “so rt” function 


algorithms, you need to include 
this header file. 


E E, The STL provides you with a 
#include <algorithm> fast sorting function which 


works on arrays and vectors! 
int main () 


{ 


It will sort all of the items in 
vector<string> n; 


ascending (increasing) order. 


n.push_ back ("carey") ; To sort, you pass in two iterators: 
n.push_back (“bart") ; 


n.push_back ("alex") ; one to the first item... 


and one that points just past 
part carey] the last item you want to sort. 


carey | bart | alex alex 


_ í 
sort ( n.begin( ), n.end( ) ); You can similarly pass in 
addresses to sort arrays! 
Tar EELEE a Finally, you can use sort() to 
fy The Tirst H rems AH order objects based on your 
sort ( &arr[0], &arr[4] ); own arbitrary criteria! 


#include <algorithm> 


class Dog 


{ 
public: 


int getBark() { return m_barkVolume; } 
int getBite() { return m_bitePain; } 


ae 


// returns true if dog A should go before dog B 
bool customCompare(const Dog &a, const Dog &b) 


{ 
if (a.getBite() > b. getBite()) 
return true; // Dog a has a nastier bite! 
if (a.getBite() < b.getBite()) 
return false; // Dog b has a nastier bite! 


return a.getBark() > b.getBark(); 
} 


int main () 


{ 
Dog arr[4] = {...}; 


sort (arr, arr+4, &customCompare): 


The “sort” function 


You can use the sort function to 
sort a bunch of items in many 
different arbitrary. 

For example, lets say we want to 
sort Dogs based on how nasty their 
bite is first, and how loud their 
bark is, second... 

Here's how do do that: 

First, you define a new function 
that can compare two Dogs, A 
and B. The function must: 


return true if A belongs before B 
return false if A belongs after B. 


For instance, our customCompare 
function will place dogs witha 
bigger bite before dogs with a 
smaller bite and break ties by the 
loudest bark... 

We then pass ina pointer to our 
function to the sort() function 
and it will use the passed-in 
comparison function to figure out 
how to order the items! 


Part 6: Compound STL Data Structures 


Let's say you want to - 
i l i #include <map> 
maintain a list of courses | include <list> 


“ 7 . u E A aa — 
pom cach WEA SUREN class Course alia J E 
{ pcre ee Re ee eee 

How could you do it public: eles 


with the STL? } 
l int main() 
Well, how about creating a í 
map between a map<string, list<Course>> crsmap:; 
student's name and their 


li f 5 Course cl("cs","32"), 
Ist of courses: c2(“math","3b"), 


c3(“english","1"); 
In many cases, you'll want to 
combine multiple STL 


crsmap[ carey" ].push_back(c1); 
crsmap[ carey’), push_back(c2); 
containers to represent more crsmap[ ‘david"].push_back(c1); 


complex associations like this! 


: STL Challenges 


Design a compound STL 
data structure that allows 
us to associate people (a 
Person object) and each 
person's set of friends 
(also Person objects). 


Design a compound STL 
data structure to 
associate people with the 
group of courses (e.g., 
Course objects) they've 
taken, and further 
associate each course with 
the grade (e.g. a string 
like “A+") they got for 
that course. 


class Person 


{ 

public: 
string getName () ; 
string getPhone() ; 


}; 


bool operator<(const Person &a, const Person &b) 


return (a.getName() < b.getName()): 


map<Person,set<Person> > facebook; 


// you could do this... 


map<Person,map<Course, string> > x; 


e Don't forget: If you're mapping your own class or 
struct to something else you'll need to define the 
operators for it 

e Also, if you have a set containing your own class 
you'll need to define the operators for it 


i Appendix - On Your Own Study 


. Inline Functions 
- Template Exercise 


* More STL Algorithm Functions 
- find() 
- find_if() 


template <typename Item> 


Inline Methods 


class Foo 


{ 

public: 
void setVal(Item a); 
void printvVal () 


Since my entire 

body is defined 

inside the class 

declaration, I'm 

inline by default 
in C++, 


When you define a function as being inline, you ask 
the compiler to directly embed the function's logic 
into the calling function (for speed). 

By default, all methods with their body defined 
directly in the class are inline. 

When the compiler compiles your inline function, it 


{ 
cout << “The value is: `“; 
cout << ma << Dao 

} 


basically copies the body of your function directly 
to where the function was being called, eliminating 
the function call. 

e By replacing the function call to printVal with its 
actual code, this reduces the amount of jumping 


private: 
Item m a; 


Since my code is defined outside 
the class declaration, I'm not an 
inline method unless the 
programmer explicitly says so. 


around your program must do, speeding it up! 

This is transparent during compilation, so you don't 
see it happening. 

Technically, C++ is not required to honor inline 
keyword - this is just a request by the programmer 


inline template <typename Item> 
void Foo<Item>: :setVal(Item a) 


to the compiler. 
e Be careful, while inline functions can speed up your 
program, they also can make your EXE file bigger! 


{ 


int main () 


{ 
Foo<int> nerd; 
nerd.setVal (5) ; 
nerd.printVal();— 
nerd.setVal (10) ; ~~~ 
} 


|W 


| 


| 


} 


int main () 


Foo<int> nerd; 
nerd.m a = 5; 


cout << “The value is: `“; 
cout << nerd.ma << Hn s 
nerd.m a 10; 
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class Stack 
{ 
public: 
Stack () 
{ m_top = 0; } 
void push( int v ) 
{ 
m items[m_topt+] = v; 
} 
int pop(); 
private: 
int m_items[100]; 
int m_top; 


he 


int Stack: :pop() 
{ 


return m_items[--m_top] ; 


} 


Template Exercise 


Part #1 


Convert this Stack class to one 
that can hold any type of data. 


Part #2 


Show how you would create a 
stack of Dogs and push Fido on. 


int main () 


{ 
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The STL “find” Function 


#include <list> 
#include <algorithm> 


int main () 


{ 


list<string> names; 
// £111 with a bunch of names 


list<string>::iterator a, b, itr; 


a = names.begin(); // start here 
b = names.end(); // end here 


a 
if (itr == Val 


cout << “I failed!”; 
else 
cout << “Hello: “ << *itr; 


itr = find( b , “Judy” ); 


The STL provides a find function that 
works with vectors/lists. 

(They don't have built-in find methods 
like map & set) 

Make sure to include the algorithm 
header file! 

The first argument is an iterator that 
points to where you want to start 
searching. 

The second argument is an iterator that 
points JUST AFTER where you want to 
stop searching! 

The final argument is what you're 
searching for. 

And just like set and map's find methods, 
this version returns an iterator to the 
item that it found. 

And if find couldn't locate the item, it will 
return whatever you passed in for the 
second parameter. 

So make sure to check for this value to 
see if the find function was successfull 
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The STL “find” Function 


#include <list> 
#include <algorithm> 


int main () 


{ 


list<string> names; 
// £111 with a bunch of names 


list<string>::iterator a, b, iter; 


a = names.begin(); // start here 
b = names.end(); // end here 


itr = find( a , b , “Judy” ); 


if (itr == b) 
cout << “I failed!”; 
else 
cout << “Hello: “ << *itr; 


Silvia 


In this example, since Judy is not in our 
list, the find() function will return the value 
of b, or in this case, names.end() 

Note: The second parameter need not 
always point at the end of the list/vector. 
If you just wanted to search the first 500 
items of a list of 10k items, you could just 
pass in an iterator to the 5015 item as the 
second parameter. 


65 


The STL “find” Function 


#include <iostream> 


#include <algorithm> 


using namespace std; 


int main () 


{ 


a 
[0] 
[1] 
[2] 
[3] 


int a[4] = {1,5,10,25}; [4] 


int "ptr; 


ptr = find(&a[0],&a[4],19); 


if (ptr == &a[4]) 


cout << “Item not found!\n”; 


else 


cout << “Found ” 


<< *ptr; 


This find function also 
works with arrays! 


For the first argument, 
pass the address where 
you want to start 
searching in the array. 


For the second argument, 
pass the address of the 
element AFTER the last 

item your want to search. 


find will return a pointer 
to the found item, or to 
the second parameter if 
the item can't be found. 
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#include <iostream> 
#include <algorithm> 
using namespace std; 


bool is _even(int n) // predicate func 


} 
or pir 
int main () 
{ 
int a[4] = {1,5,10,25}; 
int *ptr: 
ptr = find if(é&a[0],é&a[4],1s_ even) ; 


if (ptr == &a[4]) 

cout << “No even numbers!\n”; 
else 

cout << 


“Found even num: “<<*ptr; 


The find _if Function 


The find_if function loops through a 
container/array and passes each item to a 
“predicate function” that you specify. 


Your predicate function must take ina 
single value as a parameter (the type 
must match the type of values in your 

container), and return a true if the value 
matches the predicate, false otherwise. 


find_if processes each item in the 
container until the predicate function 
returns true or it runs out of items. 


find_if returns an iterator/pointer to 
the first item that triggers the 
predicate function. 
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#include <iostream> 
#include <algorithm> 
using namespace std; 


is even(int n) 


int a[4] = {1,5,10,25}; 
int *ptr; 
ptr = find if (é&a[0],é&a[4],is even); 


if (ptr == é&a[4]) 
cout << “No even numbers! \n”; 
else 


cout << “Found even num: “<<*ptr; 


The find _if Function 


Your predicate function 
must return a boolean 
value. 


The predicate function 

must accept values that 

are of the same type as 
the ones in the 
container/array. 


So find_if provides a 
convenient way to locate 
an item ina set/map/ 
list/vector that meets 
specific requirements. 


(your predicate function's logic 
determines the requirements) 


